1 SERVICE CONTROL MANAGER SECURITY MANAGER LOOKUP 

2 Technical Field 

3 The present invention relates to system administration management, and, in particular, to service 

4 control manager modules. 

5 Background 

6 Tool definition and execution in a service control manager (SCM) module may involve 



7 complicated processes, including authorizing a user to run a tool on target nodes. To ensure system 

8 security, a process for checking user authorization is needed before the user is allowed to execute the 

9 tool on the target nodes. Prior solutions include the use of a database that contains the authorized user 

1 0 identification to run a certain tool. However, the use of the database requires a complicated database 

1 1 application to be installed on the system, and requires the database application to be constantly updated 

12 through manual input. A simple user authorization checking process is needed. 

13 Summary 

1 4 Role based authorization in a service control manager (SCM) module may allow a system 

1 5 administrator to delegate responsibility to other users by assigning tool based roles to these users on 

1 6 a system to provide them with full access to such system. To ensure system security, after receiving 

1 7 a request from a user to run a tool on a set of target nodes, an SCM security manager may need to 

1 8 check whether the user is authorized to run the tool on the target nodes in order to validate the user' s 

1 9 authorization. 

2 0 The method for validating a user ' s authorization to run a tool in the SCM module by the security 

2 1 manager may include obtaining user identification (ID), a list of target nodes on which to run the tool, 

22 and tool definition from a runnable tool obj ect created by the SCM module based on task information 

23 provided by the user and tool definition provided by a domain manager. Next, the security manager 

24 may obtain roles associated with the tool from the tool definition, and check if any of the roles are 

25 enabled. If any of the roles are enabled, the security manager may then check if the user is authorized 

26 on all of the nodes, and if the user is authorized for one of the tool's enabled roles on all of the nodes. 

27 Only if the user is assigned with any of the tool' s enabled roles on all of the target nodes, the security 
2 8 manager will report back to the SCM module indicating that the tool is runnable by the user. If the user 
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1 is not authorized on each of the nodes requested, or if the user is not authorized for any of the tool's 

2 enabled roles, the tool is not runnable by the user. 

3 Description of the Drawings 

4 The detailed description refers to the following drawings, in which like numbers refer to like 

5 elements, and in which: 

6 Figure 1 illustrates a computer network system with which the present invention may be used; 

7 Figure 2 illustrates the relationships between the user, role, node, tool and authorization objects; 

8 Figure 3 is a block diagram of an exemplary server used to implement the present invention; 

9 Figure 4 is a flow chart of a method for checking a user's authorization to run a tool in the SCM 
CJJ 10 module by a security manager; and 

S.' 1 1 Figure 5 is a flow chart of a method for checking a user' s authorization to run a tool after 

j;; 12 receiving a tool execution request from the user. 

;2 13 Detailed Description 

= 14 A service control manager (SCM) module multiplies system administration effectiveness by 

15 distributing the efiectsofexisting tools efficiently across managed servers. The phrase "service control 

l. 1 6 manager" is intended as a label only, and different labels can be used to describe modules or other 

f- 17 entities having the same or similar functions. 

18 In the SCM domain, the managed servers (systems) are referred to as "managed nodes" or 

19 simply as "nodes". SCMnode groupsare collections ofnodesinthe SCMmodule. Theymayhave 

20 overlapping memberships, such that a single node may be a member of more than one group. The 

2 1 grouping mechanism may allow flexible partitioning of the SCM module so that users may use it to 

22 reflect the way nodes are already grouped in their environment. 

2 3 Figure 1 illustrates a computer network system with which the present invention may be used. 

24 The network system includes an SCM 1 1 0 running on a Central Management Server (CMS) 1 00 and 

25 one or more nodes 1 30 or node groups 132 managed by the SCM 1 1 0. The one or more nodes 1 3 0 

26 and node groups 132 make up an SCM cluster 140. 

27 The CMS 1 00 can be implemented with, for example, an HP-UX 1 1 .x server running the SCM 

28 110 software. The CMS 1 00 includes a memory 1 02, a secondary storage device (not shown), a 
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1 processor 1 08, an input device (not shown), a display device (not shown), and an output device (not 

2 shovm) . The memory 1 02 may include computer readable media, RAM or similar types of memory, 

3 and it may store one or more appHcations for execution by processor 108, including the S CM 110 

4 software. The secondary storage device may include computer readable media, a hard disk drive, 

5 floppy disk drive, CD-ROM drive, or other types of non- volatile data storage. The processor 108 

6 executes the SCM software and other application(s), which are stored in memory or secondary 

7 storage, or received from the Internet or other network 116. The input device may include any devfce 

8 for entering data into the CMS 100, such as a keyboard, key pad, cursor-control device, touch-screen 

9 (possibly with a stylus), or microphone. The display device may include any type of device for 

1 0 presenting a visual image, such as, for example, a computer monitor, flat-screen display, or display 

1 1 panel. The output device may include any type of device for presenting data in hard copy format, such 

12 as a printer, and other types of output devices include speakers or any device for providing data in 

1 3 audio form. The CMS 1 00 can possibly include multiple input devices, output devices, and display 

14 devices. 

1 5 The CMS 1 00 itself may be required to be a managed node, so that multi-system aware 

1 6 (MSA) tools may be invoked on the CMS. All other nodes 1 30 may need to be explicitly added to 

17 the SCM clusterl40. 

1 8 Generally, the SCM 110 supports managing a single SCM cluster 1 40 from a single CMS 100. 

19 All tasks performed on the S CM cluster 1 40 are initiated on the CMS 100 either directly or remotely, 

20 for example, by reaching the CMS 1 00 via a web connection 1 1 4. Therefore, the workstation 1 20 at 

2 1 which a user sits only needs a web connection 114 over a network 116, such as the Internet or other 

22 type ofcomputer network, to the CMS lOOinordertoperformtasksontheSCM cluster 140. The 

23 CMS 1 00 preferably also includes a centralized data repository 1 04 for the S CM cluster 1 40, a web 

24 server 1 1 2 that allows web access to the SCM 110 and a depot 1 06 that includes products used in the 

25 configuring of nodes 130. A user interface may only run on the CMS 1 00, and no othernode 130in 

26 the SCM module may execute remote tasks, access the repository 1 04, or any other SCM operations. 

27 Although the CMS 100 is depicted with various components, one skilled in the art will 

28 appreciated that this server can contain additional or different components. In addition, although 
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1 aspects of an implementation consistent with tlie present invention are described as being stored in 

2 memory, one skilled in the art will appreciated that these aspects can also be stored on or read from 

3 other types of computer program products or computer-readable media, such as secondary storage 

4 devices, including hard disks, floppy disks, or CD-ROM; a carrier wave from the Internet or other 

5 network; or other forms of RAM or ROM. The computer-readable media may include instructions 

6 for controlling the CMS 100 to perform a particular method. 

7 A central part of the SCM module 11 0 is the ability to execute various management commands 

8 or applications on the one or more nodes simultaneously. The commands or apphcations may need to 

9 be encapsulated with an SCM tool, which is typically used to copy files and/or execute commands on 

1 0 the target nodes 130. The S CM tool may run simple commands such as bdf ( 1 ) or mount ( 1 M), launch 

1 1 single system interactive applications such as System Administration Manager (SAM) or Glance, launch 

1 2 multi-system aware applications such as Ignite/UX or Software Distributor (SD), or perform other 

1 3 functions. The tool may be defined using either an SCM tool definition language through command line 

14 interface (CLI) or an SCM-provided graphical user interface (GUI). 

1 5 There are two general types of tools: single-system aware (SSA) tools and multi-system aware 

16 (MSA)tools. SSA tools may run on anode 130 and may only affect the operation of that node 130. 

17 To run SSA tools on multiple target nodes 130, the SCM module 1 1 0 may execute the tools on each 

18 targetnode 130. In addition to executing commands or launching applications, SSA tools may copy 

19 files from the CMS 100 to the target nodes 130. Files may only be copied from the CMS 100 to the 

20 managed nodes 130 in this exemplary embodiment, not from the nodes 130backtotheCMS 100. 

21 MSA tools may run on a single node 1 3 0 but may be able to operate on multiple other nodes 

22 130. MSA tools are applications that execute on a single node but can detect and contact other nodes 

23 to accomplish their work and this contact is out of the control of the SCM module 110. This type of 

24 apphcationmayneedtohaveaUstofnodes 130 passed as an argument at runtime. Anode 130 where 

25 the application will execute may need to be specified at tool creation time, not at runtime. The target 

26 nodes 1 30 selected by the user may be passed to an MSA tool via atarget environment variable that 

27 contains a target node list for the MSA tools. MSA tools may not copy files to either the manager node 

28 1 00 or to the target nodes 1 3 0 in this exemplary embodunent. Therefore, an execution command string 
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1 may be required for MSA tools. 

2 An SCM user may be a user that is known to the SCM module 1 1 0 and has some SCM 

3 related privileges and/or system management roles. An SCM role, which is an expression of intent and 

4 a collection of tools for accomplishing that intent, typically defines what the user is able to do on the 

5 associated nodes 130 or node groups 132, e.g., whether a user may run a tool on a node 130. 

6 Typically, in order to start the SCM module 1 1 0 or execute any SCM tools, the user may need to be 

7 added to the SCM module 1 1 0 and authorized either via the GUI or the command line interface (CLI). 

8 All SCM module 110 operations may be authorized based on the user's SCM authorization 

9 configuration, and/or whether or not the user has been granted SCM trusted user privilege. 

1 0 The SCM user may, depending upon the roles assigned, manage SCM systems via the SCM 

1 1 module 1 1 0. In addition, the user may examine the SCM module log, and scan the group and role 

1 2 configurations. When the SCM user runs a tool, the result may be an SCM task. The SCM module 

13 110 typically assigns a task identifier for every task after it has been defined and before it is run on any 

1 4 target nodes 130. This identifier may be used to track the task and to look up information later about 

1 5 the task in an SCM central log. 

16 An SCM trusted user is an SCM user responsible for the configuration and general 

1 7 administration of the SCM module 110. The trusted user is typically a manager or a supervisor of a 

1 8 group of administrators whom a company trusts, or other trusted individual. Entrusted with the highest 

1 9 authority, the trusted user may execute any system management task with all of the nodes (machines) 

20 managed bythe SCM module 110. The capabilities ofthe trusted user include, for example, one or 

2 1 more of the following : creating or modifying a user' s security profile, such as user ID or user' s set of 

22 SCM authorizations; adding, modifying or deleting a node or node group; enabling or disabling roles; 

23 modifying or authorizing tools. The granting of these privileges implies a tmst that the user is responsible 

24 for configuring and maintaining the overall structure of the SCM module 1 1 0. 

25 An SCM authorization model supports the notion of assigning to users the ability to run a set 

26 of tools on a set of nodes. An authorization obj ect is an association that links a user to a role on either 

27 a node or a node group. Each role may have one or more tools and each tool may belong to one or 

28 more roles. When users are given the authority to perform some limited set of functionality on one or 
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1 more nodes, the authorization is done based upon roles and not on tools . The role allows the sum total 

2 of functionality represented by all the tools to be divided into logical sets that correspond to the 

3 responsibilities that would be given to the various administrators. Accordingly, there are different roles 

4 that may be configured and assigned with authorization. For example, a backup administrator with a 

5 "backup" role may contain tools that perform backups, manage scheduled backups, view backup 

6 status, and other backup functions. On the other hand, a database administrator with a "database' ' role 

7 may have a different set of tools. When a user attempts to run a tool on a node, the user may need to 

8 be checked to determine if the user is authorized to fulfill a certain role on the node and if that role 

9 contains the tool. Once a user is assigned a role, the user may be given access to any newly created 

1 0 tools that are later added to the role. In the example given above, the backup administrator may be 

1 1 assignedthe "backup" role for a group ofsystems that run a specific application. Whennewbackup 

1 2 tools are created and added to the "backup' ' role, the backup administrator may immediately be given 

1 3 access to the new tools on the systems. 

1 4 Figure 2 illustrates the relationships between the user 210, role 220, node 1 3 0, tool 240, and 

15 authorization 250 objects. User objects 210 represent users 210, role objects 220 represent roles 

16 220, node objects 130 represent nodes 130, tool objects 240 represent tools 240, and authorization 

1 7 objects 250 represent authorizations 250. However, for purposes of this application, these terms are 

1 8 used interchangeably. Each authorization obj ect 250 links a single user obj ect 2 1 0 to a single role 

1 9 object 220 and to a single node object 130 (or anode group object 132). Each role object 220 may 

20 correspond to one or more tool objects 240, and each tool object 240 may correspond to one or more 

2 1 role objects 220. Each user object 210 may be assigned multiple authorizations 250, as may each role 

22 obj ect 220 and each node obj ect 130. For example. Role 1 may contain Tools l-N,andUser 1 may 

23 be assigned Roles 1 -M by the authorization model on Node 1 . Consequently, User 1 may run Tools 

24 1 -N on Node 1 , based upon the role assigned. Role 1 . 

25 Table 1 illustrates an example of a data structure for assigning tools 240 and commands 

26 specified in the tools 240 to different roles 220. Table 2 illustrates an example of a data structure for 

27 assigning the roles 220 to different users 210. 
28 
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1 5 Although Figure 2 shows a node authorization, a similar structure exists for a node group 1 32 

1 6 authorization. The SCM authorization model may be deployed by using node group 1 32 authorizations 

1 7 more often than node 130 authorizations. This model makes adding new nodes simpler because by 

1 8 adding a node 1 30 to an existing group 1 32, any authorizations associated with the group 132 may be 

19 inherited at run-time by the node 1 30. 

20 The authorization model for determining if a user may execute a tool 240 on a set of nodes 1 30 

2 1 may be defined by an "all or none" model. Therefore, the user 2 1 0 must have a valid authentication 

22 association for each target node 130 to execute the tool 240. If authorization does not exist for even 

23 one of the nodes 130, the tool execution fails. 

24 The SCM module 1 1 0 may also include security features to secure transactions that transmit 
2 5 across the network. All network transactions may be digitally signed using a public or private key pair. 

26 The recipient of network transmissions may be assured of who the transmission came from and that the 

27 data was not altered in the transmission. A hostile party on the network may be able view the 
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1 transactions, but may not counterfeit or alter them. 

2 Referring to Figure 3, the CMS 1 00 may include a domain manager 330, a log manager 334, 

3 and a tool manager 336. The domain manager 330 is the "brain" of SCM module llOandmaybe 

4 connected to the repository 1 04 for storage of the definitions of all the objects. A security manager 

5 332, which is a subsection of the domain manager 330, typically guards the system security by checking 

6 whether the user 2 1 0 is authorized to run the tool 240 on all of the nodes 1 30 requested, i.e., whether 

7 the user 210 is assigned the roles 220 associated with the tool 240 on all of the nodes 130. For 

8 example, if a user 2 1 0 requests to run a tool 240 on two nodes 130, and the user 2 1 0 is only authorized 

9 to run the tool on one node 130 but not the other, the SCM module 11 0 will not run the tool 240 on 

1 0 either node, due to the "all or none" authorization model. The log manager 334 may manage a log file 

1 1 and take log requests and write the requests to the SCM log file. The tool manager 336 typically 

12 validates the roles 220 associated with the tool 240. 

13 Tool execution may start with a request fi-om the user 2 1 0 to run a tool 240 on one or more 

1 4 nodes 130. The request may include task information, such as the name of the tool to be run, the 

1 5 location of the tool, the nodes on which to run the tool, and required arguments of the tool, if any. An 

1 6 example of tool execution is described in United States patent application of Lister, Sanchez, Drees, 

1 7 and Finz, entitled "Service Control Manager Tool Execution", and filed on the same day herewith, 

1 8 which is incorporated herein by reference. 

19 In the next step, the SCM module 1 1 0 may retrieve tool definition, node definition and user 

20 definition fi-om the domain manager 33 0 to validate the task information received from the user 210. 

2 1 The domain manager 330, connected to the repository 1 04, may be contacted to provide tool definition 

22 or information about the nodes 1 3 0 or the user 2 1 0 whenever the clients need to look up a tool 240 

23 or to verify nodes 1 3 0. An example of tool definition is described in United States patent application 

24 of Lister, Sanchez, Drees, and Finz, entitled "Service Control Manager Tool Definition", and filed on 

25 the same day herewith, which is incorporated herein by reference. The validation of the task 

26 information may include checking whether the nodes requested are the managed nodes, whether the 

27 tool s actually exist, and whether the required argtiments of the tool are given. After the request is 

28 validated, the SCM module 1 lOmaycreatearunnabletoolobjectbasedonthetaskinformationand 



1 the tool definition. The runnable tool object may encapsulate the tool 240, the task information received 

2 from the user 2 1 0, and information that may be picked up from the environment, such as the user ' s 

3 name. 

4 Authorizations for the S CM module 1 1 0 may be tuples, including the user 2 1 0, the role 220 

5 andthenode 130. Internally, thesecuritymanager332maystore,forexample,anidentificationofthe 

6 users 210 by their UNIX login ID and the roles 220 by their (immutable) SCMrolelD. Forexample, 

7 if U represents a user ID, R represents a role ID, and N represents a node name, the set of all 

8 authorizations for the SCM module 1 1 0 may comprise numerous discrete points tuples of the form (U, 

9 R, N) - in a three dimensional space. The set of all configured authorizations may be referred to as an 

1 0 SCM security policy. The security manager data obj ect that stores all the data obj ects described by 

11 the S CM security policy may form, for example, a Java hash table. The hash table is a common data 

1 2 structure for providing fast indexing of information by providing an algorithm that computes some type 

1 3 of address based on a hash key. 

1 4 There are numerous ways of accessing the security policy of the SCM module 110, based on 

15 a request by the user 210. While numerous ways of viewing this data are provided, an algorithm for 

1 6 lookup may be designed for the most common scenario: validating whether a user 2 1 0 can execute a 

17 tool 240 on one or more nodes 1 30 by checking whether the user 2 1 0 is assigned any of the tool' s 

1 8 enabled roles 220 on the nodes 130. 

1 9 The first step for security manager lookup may be synchronizing on a mutual exclusion mutex. 

20 Mutexes are simple lock primitives that can be used to control access to a shared resource - the 

2 1 security policy. The mutex is basically a synchronization obj ect to prevent corruption of data by 

22 concurrently accessing the data with different threads. Only one thread or user process is able to 

23 manipulate the contents of the cache at one time, and only by acquiring the mutex. Other users must 

24 wait until the first user releases the mutex before the USPRS can modify the data. Accordingly, 

25 coherency of the data maintained by the security manager 332 may be preserved. There is no Java- 

26 specific synchronization on the mutex that controls access to the security policy hash table. 

27 Next, from the runnable tool object, the security manager 332 may obtain the user identification 
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1 (ID) of the user 2 1 0 on whose behalf the tool 240 is to be executed, a list of target nodes 1 3 0 on which 

2 the user 2 1 0 intends to execute the tool 240 , and a tool definition that contains role information that 

3 must be extracted for the authorization lookup to complete. In order to execute the tool 240, the user 

4 210 must be authorized for at least one of the tool's enabled roles 220 on each target node 1 30 in this 

5 exemplary embodiment. Then, the tool manager 336 may check if the roles 220 are valid. 

6 Some of the roles 220 assigned to the tool 240 may be disabled, preventing the tool 240 from 

7 being executed by the user 2 10 who is authorized for the role 220 onthe target node 130. Therefore, 

8 the security manager 332 may need to check that not all roles 220 associated with the tool 240 are 

9 disabled. 

10 Next, the securitymanager332mayobtaintheuser'sauthorizedroles220oneachtargetnode 

11 130 from the hash table, referred to as MxNodeRolelDHash, using the user ID as the hash key. This 

12 may be done by accessing three dimensional data on the user access, resulting in information that 

1 3 describes the roles 220 for which the user 2 1 0 is authorized on one or more nodes 1 3 0, i.e., the user's 

14 authorized roles 220. The hash table may be indexed by node name, and the data stored in the hash 

15 table, on a pernode basis, may be a vector ofthe user's authorized roles 220 on the node 130. Vector 

16 is a Java term, and may be referred to as a collection of data. 

1 7 If, however, an attempt to obtain the user's authorized roles 220 from the hash table results in 

1 8 nothing being returned, then the user 210 has no authorizations in the security policy, and the user 2 1 0 

19 cannot run any tools 240 in the SCM environment. 

20 The authorization lookup may involve matching two sets of roles 220. The first set of roles 220 

21 is the vector of (enabled) roles 220 assigned to the tool 240. The second set of roles 220 is a vector 

22 of all roles 220 (enabled or not) the user 2 1 0 is authorized on the current node 130. The security 

23 manager 332 typically iterates through the vector of the tool 's enabled roles 220, and checks if the user 

24 210hasbeenauthorizedforoneoftheseroles220 onthe node 130. Ifthe intersection ofthe vector 

25 (a set) of the tool's enabled roles 220 and the vector (another set) ofthe user's authorized roles 220 

26 for the current node 1 30 is not the empty set, then there may exist an authorization in the security policy 

27 that allows the user 210 to execute the tool 240 on the current node 130. Ifthe intersection ofthe two 
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1 role vectors is an empty set, then authorization lookup fails, and the user 2 1 0 cannot run the tool 240. 

2 In summary, the authorization lookup effectively leverages two of the collections provided by, 

3 for example, the Java language, hash tables and vectors, to allow a novel way of accessing a 

4 complicated space of data. The three dimensional programming data is easily accessed and traversed 

5 in an intuitive, and problem domain-specific manner, because of the way it is maintained in the primary 

6 hash table. The elements stored and manipulated in this primary hash table are again hash tables, 

7 referred to as MxNodeRolelDHash objects. There may be one of these MxNodeRolelDHash objects 

8 foreachnode 130onwhichanSCMuser210isauthorizedarole220. Giventhatthe most common 

9 use of this lookup mechanism is for a scenario where the user ID may be considered constant, one 

1 0 dimension of data complexity is removed rapidly by indexing into the primary hash table by the user 

1 1 name. Theresultingobject,referredtoasMxNodeRoleIDHash,maymaptheuser'sauthorizedroIes 

12 220 to nodes 1 3 0 for which those roles 220 apply. Then the lookup may be a matter of determining 

1 3 if there is at least one role 220 that is common to the tool's enabled roles 220 and the user's authorized 

14 roles 220, for each target node 130. 

1 5 Figure 4 is a flow chart of a method for checking a user' s authorization to run a tool 240 in the 

1 6 SCM module 1 1 0 by a security manager 332. This method may be implemented, for example, in 

1 7 software modules for execution by processor 108. The first step may be synchronizing on the mutual 

1 8 exclusion (MUTEX), step 402. Next, the security manger 332 may obtain user identification (ID), a 

19 list of the target nodes 130, and the tool definition from the runnable tool object created by the SCM 

20 module 1 1 0 based on the task information and the tool definition, steps 404, 406, 408. The tool 

2 1 definition may indicate the roles 220 assigned, typically by the trusted user, to run the tool 240, step 

22 410. Theroles220mayneedtobevalidatedbythetoolmanager336,step412. Next, the security 

23 manager 332 may execute a loop to check the user's authorization to run the tool 240 on the target 

24 nodes 130. Ifall roles 220 are disabled, step 4 14, the tool 240 may be determined as not runnable at 

25 all, step 424. Conversely, if not all roles 220 are disabled, for every node 1 30 in the list of target 

26 nodes, the security manager 332 may check if the user 210 is assigned an authorized role 220 on the 

27 node 130, step 416. If the user is authorized, for each authorized target node 130, the security 

28 manager 332 may obtain the user's authorized roles 220 for the node 130, step 418. 
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1 Next, for each tool's enabled role 220, the security manager 332 may check if the user 2 1 0 

2 is authorized for at least one of the tool's enabled roles 220 on that node 130, step 420. If the 

3 intersection of the vector of the tool's enabled roles 220 and the vector of the user' s authorized roles 

4 220 for the node 1 30 is not the empty set, then there may exist an authorization that allows the user 2 1 0 

5 to execute the tool 240 on that node 1 30. Only if the user 210 is assigned with one of the tool's 

6 enabled roles 220 on all of the target nodes 1 30, the tool 240 is runnable by the user 2 1 0, step 426. 

7 If the user 2 1 0 is not authorized on each of the nodes 1 3 0 in the target node list, or if the user 2 1 0 is 

8 not authorized for any of the tool's enabled roles 220, the tool 240 is not runnable by the user 210, step 

9 424. 

1 0 While the present invention has been described in connection with an exemplary embodiment, 

11 it will be understood that many modifications will be readily apparent to those skilled in the art, and this 

12 application is intended to cover any variations thereof 
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